home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1994 January / PSL Monthly Shareware CD-ROM (Public Software Library) (January 1994).iso / games / dos / word / qtfall.exe / QTFALL.DOC < prev    next >
Encoding:
Text File  |  1989-05-31  |  14.7 KB  |  338 lines

  1. ------------------------------------------------------------------
  2. << QTFALL.EXE  - QUOTE FALL PUZZLE MAKER PROGRAM by Bill Morgan >>
  3. ------------------------------------------------------------------
  4. Welcome to Quote Fall!                            ver 2.1, 5/89
  5.  
  6. This is a fun little program that makes a kind of word puzzle
  7. called a "Quote Fall" puzzle. In this type of puzzle a quotation
  8. is laid out and then scrambled as if the letters in each column had
  9. "fallen" downward.
  10.  
  11. That is, the letters for each column of the puzzle are directly
  12. above it in the clue section, but in a different vertical order.
  13. The "blocks" or filled places are the spaces between the words.
  14. (See the sample below).
  15.  
  16. You can solve the puzzle by looking for little words first, common
  17. letter combinations, etc. and then crossing off those letters from
  18. the clue lines. The more you get, the easier it becomes. Soon you
  19. will have the quotation or message unfolding before your very eyes!
  20.  
  21. ----------------------------------------------------------------
  22. THE CLUES:
  23.  
  24. │T│A│Z│U│H│E│S│A│A│M│U│L│E│D│A│A│T│N│L│D│I│P│H│E│H│L│E│N│T│A│P│A│T│D│F│
  25. │T│H│I│C│L│I│E│O│L│Q│L│L│N│A│U│D│S│O│E│F│S│T│L│A│Z│R│E│M│U│E│H│L│N│I│N│
  26. │A│U│K│N│S│T│A│R│F│A│N│N│T│O│F│I│Z│F│R│I│L│N│U│T│I│I│W│T│C│T│R│S│E│D│ │
  27. │M│H│E│S│O│S│C│ │A│U│F│O│ │P│L│Z│O│T│A│E│ │E│N│O│D│D│S│O│T│Y│L│A│ │O│ │
  28. │P│E│Q│E│ │ │C│ │K│I│B│U│ │H│T│I│W│L│I│L│ │P│R│Z│G│L│A│ │W│A│R│D│ │ │ │
  29. │ │ │A│Z│ │ │ │ │ │ │M│D│ │ │ │ │ │ │ │ │ │ │ │ │ │O│ │ │ │T│ │E│ │ │ │
  30.  
  31.  
  32. A SIMPLE SAMPLE PUZZLE:
  33.  
  34. │ │ │ │ │▒│ │ │▒│ │▒│ │ │ │▒│ │ │ │ │ │ │▒│ │ │ │ │ │ │ │▒│ │ │ │ │▒│▒│
  35. │ │ │ │ │ │▒│ │▒│ │ │ │ │▒│ │ │▒│ │ │ │ │▒│ │ │ │ │ │ │▒│ │ │ │ │ │ │▒│
  36. │ │▒│ │ │ │ │ │▒│ │ │ │ │▒│ │ │ │ │ │ │▒│ │ │▒│ │ │ │ │▒│ │ │ │ │▒│ │ │
  37. │ │ │ │ │ │ │▒│ │▒│ │ │ │ │ │ │ │ │ │▒│ │ │▒│ │ │ │ │▒│ │ │ │▒│ │ │ │▒│
  38. │ │ │ │ │▒│ │ │ │ │ │ │ │ │ │▒│ │ │▒│ │ │▒│ │ │ │▒│ │ │ │ │ │ │ │▒│ │ │
  39. │▒│ │ │ │ │▒│ │ │ │ │ │ │▒│ │ │ │▒│ │ │ │ │ │ │▒│ │ │ │ │ │ │ │ │▒│▒│▒│
  40.  
  41.  
  42. (AND HERE IS THE ANSWER KEY:)
  43.  
  44. │T│h│i│s│ │i│s│ │a│ │f│u│n│ │l│i│t│t│l│e│ │p│r│o│g│r│a│m│ │t│h│a│t│ │ │
  45. │m│a│k│e│s│ │a│ │k│i│n│d│ │o│f│ │w│o│r│d│ │p│u│z│z│l│e│ │c│a│l│l│e│d│ │
  46. │a│ │Q│u│o│t│e│ │F│a│l│l│ │p│u│z│z│l│e│ │I│n│ │t│h│i│s│ │t│y│p│e│ │o│f│
  47. │p│u│z│z│l│e│ │a│ │q│u│o│t│a│t│i│o│n│ │i│s│ │l│a│i│d│ │o│u│t│ │a│n│d│ │
  48. │t│h│e│n│ │s│c│r│a│m│b│l│e│d│ │a│s│ │i│f│ │t│h│e│ │l│e│t│t│e│r│s│ │i│n│
  49. │ │e│a│c│h│ │c│o│l│u│m│n│ │h│a│d│ │f│a│l│l│e│n│ │d│o│w│n│w│a│r│d│ │ │ │
  50.  
  51. ----------------------------------------------------------------
  52.  
  53. The reason I wrote this program is that my mother was always wanting me
  54. to write letters to her but I am very poor at that, and anyway whenever
  55. I sat down to do it I wound up hacking instead. But since she and I both
  56. like word puzzles I thought to myself I will write a program to make
  57. puzzles out of letters (or letters out of puzzles), and that way it
  58. will be fun for me, and fun for her. She loves to solve any kind of
  59. puzzle. Thus, this program was born. It is already working since
  60. I just sent my mom the first letter I have written in over 6 months!
  61. Of course she will have to figure out what it says by solving it, but
  62. that is the whole point. Each short paragraph is a separate QUOTEFALL
  63. puzzle!
  64.  
  65. ========================================================================
  66.  
  67. HOW TO MAKE A QUOTEFALL PUZZLE :
  68.  
  69. MAKE A QUOTE FILE
  70. 1. Type your quotes into a text file. Quotes can span several lines
  71.    in the file.  Leave one (and only one) blank line between quotes.
  72.    Each quote can be up to 1024 characters long. A puzzle that long
  73.    is probably too big. Each file can have up to 20 quotes.
  74.  
  75.    You can put comments in the file by starting the line
  76.    with a semicolon. Such lines will be ignored by the program.
  77.  
  78.    You can put author and source information in the file by starting
  79.    the line with a percent sign (%). This information will be printed
  80.    just after the puzzle. Author information should come AFTER the
  81.    quote.
  82.  
  83.    NEW 1989!
  84.    Now you can also put a title on your puzzle, as well as a copyright
  85.    message at the end. To put a title, just put a line in your quote
  86.    file, AFTER the quote, that starts with an asterisk (*). This is
  87.    the "USER" character. The line that starts with this character will
  88.    be printed before the puzzle.
  89.  
  90.    You can also define a copyright message by choosing the SETTINGS
  91.    option on the menu and selecting "Copyright". You will be asked for
  92.    the message. Enter your message. If you want this to be used each
  93.    time you run QTFALL you can then choose "SAVE SETTINGS" and it will
  94.    be recorded in the EXE file.
  95.  
  96.  
  97. EDIT THE QUOTE FILE
  98. 2. For making your quote files a text editor is included as part
  99.    of the program. Run the program and select "Editor" from
  100.    the menu, then press F1 for help with Editor. This is the
  101.    Borland Binary Editor so it is like the editor with Turbo Pascal,
  102.    Sidekick, et al.
  103.  
  104.    (EDITOR NOTES: Press F1 for a list of Editor commands.
  105.  
  106.    You can press F3 to pick a file. Note that if you pick
  107.    a directory name, you will see the files in THAT directory,
  108.    and, unlike other file pickers, you will ALSO move to that
  109.    directory.
  110.  
  111.    NOTE : Use this feature if you want to CHANGE DIRECTORY.
  112.    Just pop into the editor, MOVE around, and pop back out.
  113.  
  114.    There is an UNDOCUMENTED feature in this file picker: you can use
  115.    the space bar to MARK files and ALT-E to ERASE them. You are asked
  116.    TWICE for confirmation about this, just for safety's sake.
  117.  
  118.    Maximum file size is about 55K, memory permitting.)
  119.  
  120.  
  121. PICK A QUOTE
  122. 3. Select a quote by choosing "QUOTE" from the menu. You will be
  123.    able to specify your file name. (Default = QUOTES.DAT). Next
  124.    you will see the quotes and be asked which one. Specify the
  125.    number of the quote you want.
  126.  
  127.    You can specify the quote file name on the command line
  128.    when invoking QTFALL.
  129.  
  130. DESIGN THE PUZZLE (SIZE)
  131. 4. Next you must design the puzzle by choosing "Columns" from
  132.    the menu. This will let you change the size of the puzzle.
  133.    You can use the left/right arrow keys. The thinner you make it
  134.    the taller it will be. It can be up to 22 lines tall, but keep
  135.    in mind that the taller a puzzle is the more difficult it is to
  136.    solve. At some point it becomes impossible. Usually 5-7 lines is
  137.    good. For beginners or children 3-4 lines is good. Two lines is
  138.    ridiculously simple, and 1 line is, of course, no puzzle at all.
  139.  
  140.    You may want to pick a size that minimizes columns with only
  141.    one or two letters, thus making the puzzle more difficult,
  142.    or conversely, you may want to give the solver a head start.
  143.  
  144.    Pick a size that looks nice and is in the range of difficulty
  145.    that you want. All punctuation is removed except for apostrophe.
  146.    I kept this in because it seemed necessary for contractions.
  147.  
  148. MAKE THE PUZZLE
  149. 5. Now the puzzle is scrambled by choosing "MAKE" from the menu.
  150.    Note that you MUST size the puzzle before doing this. "MAKE"
  151.    will perform the "quote-fall", scrambling the letters vertically
  152.    and making the clue section.
  153.  
  154.    The program will check to see that no word from the puzzle
  155.    (larger that two characters) exists anywhere at all in the
  156.    horizontal lines of the clues.
  157.  
  158.    This avoids giving any subliminal help to the solver.
  159.    If you don't care about this, or if the program gets "stuck"
  160.    (this can happen with small puzzles or dangling words) just
  161.    press a key and the program will let you accept the puzzle as
  162.    it is. If it had been stuck, just re-design it ("COLUMNS").
  163.  
  164. DONE! PRINT IT OR FILE IT.
  165. 6. Now your puzzle is done! You can either print it (choose "PRINT"
  166.    from the menu) or you can write it to file (choose "FILE"). If
  167.    you write it to a file you have the option of Overwriting or
  168.    Appending. By appending you can gradually build a sequence of
  169.    puzzles in the same file. That is how I wrote my puzzle-letter to
  170.    my mother.
  171.  
  172.    When you write to a file, the puzzle will automatically be
  173.    loaded into the Editor and you can inspect it and add a title
  174.    or comments, etc.
  175.  
  176.    PRINTER CONTROL-CODES
  177.       The printer sequence just prints the puzzle and does
  178.       not set up the printer in any way.
  179.  
  180.       If you want to set up your printer in a special way you
  181.       can do it by choosing "FILE" and writing the puzzle to a file.
  182.       You will be popped into the editor. Now you can put the control
  183.       codes you want right into the file like this:
  184.  
  185.       Press CTRL-P and then continue to press CTRL and press the
  186.       contol key you want to insert in the file. Thus to place a
  187.       CTRL-Q (ASCII #17) in the file press CTRL-P and then CTRL-Q.
  188.       More commonly, you would want to put in an escape character. This
  189.       would be done by pressing CTRL-P and then CTRL-[ (ASCII #27 or
  190.       control key plus left bracket). This way you can put your printer's
  191.       code for condensed printing right into your file in order to print
  192.       wider puzzles.
  193.  
  194.       Now you can print the puzzle right from the editor by marking it
  195.       as a block, and pressing CTRL-K + P.
  196.  
  197.     (If all this is not working, check to be sure you have done the
  198.     "MAKE" step before PRINTING or FILING.)
  199.  
  200.       If the way the puzzle is printing is not to your liking then you
  201.       can "print" to a file, edit the file however you want, and then
  202.       print the file!
  203.  
  204.      NEW! FEATURES 1989 :
  205.      ------------------
  206.      Now there is an easier way to accomplish the above. You can
  207.      specify a printer SETUP file. This is merely a small text file
  208.      containing the printer codes to setup your particular printer.
  209.      You can use the QTFALL editor to make this file. You will need to
  210.      consult your printer's manual to find out what codes to send.
  211.      Each code is separated from the next by EITHER a space or a
  212.      comma.
  213.  
  214.      You can put information in the file in three ways : numeric,
  215.      literal, or comments.
  216.  
  217.      Numeric : Just type the number of the ASCII code you want to
  218.      send. The most commonly used printer code is ESCAPE which is
  219.      ASCII code 27. Typing 27 in you file (followed by a space) will
  220.      send an ESCAPE code to the printer.
  221.  
  222.      Literal : Anything surrounded by single or double quotes is just
  223.      sent to the printer as it is. Putting "E" in your file will send
  224.      a single capital E to the printer.
  225.  
  226.      Comments : Anything to the right of the comment character is
  227.      ignored. This way you can put notes in the file to remember what
  228.      the different codes do.
  229.  
  230.      EXAMPLE:   27 '@' 27 'E' 27 'F' 14  ; Clear, Bold condensed
  231.  
  232.        For an EPSON LQ this sends a printer reset code (ESCAPE @), a
  233.        code for emphasized (ESCAPE E), for doublestrike (ESCAPE F) and
  234.        a final code for condensed printing (ASCII 14).
  235.  
  236.        Everything after and including the semicolon is ignored.
  237.  
  238.       To send the comment character itself, you can just put its ascii
  239.       code in the file. Or, you could redefine it from the SETTINGS
  240.       menu.
  241.  
  242.  
  243. 7. SETTINGS
  244.  
  245.    Character Settings
  246.    ------------------
  247.    If your printer will not print the default block and delimiter
  248.    characters you can change them by choosing "SETTINGS" from the
  249.    menu. You could choose the vertical bar (|) for divider and something
  250.    like the pound symbol (#) for the block character.
  251.  
  252.    If printer does not respond, you can change the printer port number,
  253.    from LPT1: to LPT3: (thanks to Richard S. Sadowsky's routine).
  254.  
  255.    Color Settings
  256.    --------------
  257.    This is pretty obvious. Set it up how you like it and save the setup.
  258.    Next time you run it will know what colors you like.
  259.  
  260.    File Names
  261.    ----------
  262.    You can change the default file names which will be used on startup.
  263.    You can specify the drive as well, but not the whole path. This is to
  264.    allow a set-up with floppy drives. If the drive is not specified, the
  265.    current drive is assumed. (The "Help file" is the document file which
  266.    comes up if you press ALT-F1. The default is THIS file, QTFALL.DOC,
  267.    but you could make it anything, including a puzzle file you are
  268.    building). You must explicitly change the file name from the settings
  269.    menu for it to be saved by "Save Setup".
  270.  
  271.    Word Checking
  272.    -------------
  273.    You can also change the amount of checking for imbedded words
  274.    that is done on the clues. LOOSE checking looks to see that
  275.    no word has "fallen" down intact in its own column, thus making the
  276.    puzzle too easy. STRICT checking makes sure that no word in the
  277.    puzzle is ANYWHERE in the clues, thus assuring a really scrambled
  278.    clueset. Change this by choosing "CHECK" from the "SETTINGS" sub-menu,
  279.    or just press F2 to toggle it. (Check applies only to words of three
  280.    characters or more).
  281.  
  282.    Copyright Message
  283.    -----------------
  284.    This defines a string to be printed at the very end of your puzzle. It
  285.    can be used to print a copyright message, or anything else that you
  286.    want.
  287.  
  288.    Save setup
  289.    ----------
  290.    Choosing save setup alters the EXE file so that the next time
  291.    you run it the current settings will be used.
  292.  
  293. 8. HELP!
  294.    To get some brief reminders of what to do, just select INFO from
  295.    the menu. This will show a couple of screens telling some of the
  296.    above information. A SHORTCUT to the help is pressing the F1 key
  297.    when you are at the main menu.
  298.  
  299.    For further help, you can press ALT-F1
  300.    and this file that you are reading ("QTFALL.DOC") will be loaded
  301.    automatically into the editor for your perusal, providing it exists
  302.    in any directory of your current "PATH=" setting.  You can make your
  303.    own help file by changing the HELP filename to whatever you want.
  304.    Just select SETTINGS, then FILES, then HELPFILE. Save this setup and
  305.    your own file will the new help file called up by ALT-F1.
  306.  
  307. Tiny Undocumented Cosmetic Feature:
  308.    Pressing F9 will restore the title screen.
  309.  
  310. =================================================================
  311.  Well, that's it. Pretty simple. I guess this program has become an
  312.  exercise in SOFTWARE OVERKILL but I wanted to practice using the
  313.  Turbo Power routines. I hope you have as much fun making QUOTEFALL
  314.  puzzles as I had writing this program. If so, send me a note!
  315.  
  316.        Bill Morgan c/o KENIMATION
  317.        1424 North Wilcox
  318.        Hollywood, Calif. 90018
  319.        (213) 462-2680
  320.  
  321.  Have Fun!
  322.  
  323. ----------------------------------------------------------------
  324. NOTES & CREDITS :
  325.   Written in Turbo Pascal 5.0
  326.   Uses the Turbo Pascal Editor Toolbox for the binary editor unit.
  327.   Uses the Turbo Professional 5.0 library routines.
  328.  
  329.   Inspired by the Program QTFALL.BAS by Ernest E. Mau in his book
  330.   "Create Word Puzzles with your Microcomputer," Hayden Book Co., 1981.
  331.  
  332.   AND THANKS TO THE FOLLOWING AUTHORS:
  333.   Uses RS_Asm (for LPTREADY) by Richard S. Sadowsky.
  334.   Uses WRITEXEC.PAS by David Doty and David Dubois.
  335.  
  336.  
  337. (c) 1988, 1989 by Bill Morgan
  338.